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This edition is the first for our FOURTE 
year of support to the 0S9 connunity and we 
thank the 33 neabers who have already re- 
subscribed for the coning year. This edition 
will also be nailed to all neiibers on our 
nailing list as at August 1991 just in case you 
have forgotten to nail your cheque or the nail 
has been slow, tfe have received a letter fron a 
couple of nenbers advising that they will not be 
re-subscribing this year and we do appreciate 
this courtesy, thankyou. 

UGCAI. Several copies of our P.D, library 
catalogue 'UGCAT" (UserGroup Catalogue) have 
been requested and subsequently nailed, tfe 
understand, however, that sose of these were not 
readable in 40 track drives. Under 0S9 we have 
the ability to write to 40 track double sided 
disks in 80 track drives provided that the drive 
can be switched to 48 T.P.I, node. Hany 40 
track disks have been produced using this 
nethod, and in nost cases it works O.L but not 
always, apparently. 

To overcone this problen, our librarian has 
added a 40 track drive to his systen. If you 
have trouble reading any P.D. naterial, please 
return your disks to the librarian, Jean-Pierre 
Jacquet, and they will be redone at no extra 
charge. 

The UGCAT database has now been extended to 
include archives on. Disk 111, and we will update 
your copy of UGCAT at no charge if requested. 
Please include postage stanps for return 
postage. 

Please send all requests for P.D. archives 
and UGCAT to our librarian, particularly if 
using 35 or 40 track disk fornat. A copy charge 
of $2 per disk applies to any disk fornat. 

FLOPPY DISKS, tfe have noted that quite a few 
nenbers have included UM disks with their 
request for P.D. files, and we would like to 
point out that disks can be purchased at a nuch 
lower price than Tandy charge. Prices should be 
in the 50 cents to 60 cents per disk, tfe have 
purchased disks in lots of 50 for $20 at tines 
and have found these to be quite reliable when 
fornatted at 720k (80 tracks double sided). If 
you are not able to purchase disks at reasonable 



prices, please contact us and we will be able to 
obtain sone for you. 

Although we do not wish to becone suppliers 
of hardware or software, we will offer this as a 
non-profit service to nenbers in need, 

KM-1. Last nonth's edition contained a rather 
lengthy article on the HH-1 by Paul tfard of 
Interactive Media Systems, so we won't go into 
that again here, but for those interested, we 
are advised that the 'GSK'er' Issue #5 includes 
a review of the KK-i nachine. 

AHStfERS. This edition contains answers, thanks 

to Bob Devries, to questions raised by sone 

Eenbers and we hope that others nay also 
benefit. 

HSDOS to 0S9 File transfer, tfe have received a 
request for an 0S9 utility to read and write KS- 
DOS files. The archive "pcdos.ar* fron the P.D. 
library contains a progranne that will do this. 
It will only work on a 40 track drive (an 80 
track drive switchable to 48 T.P.I, is O.K.) and 
needs SDISK3 or a patched CC3Disk driver. This 
utility does not handle sub-directories on KS- 
DOS disks and requires 360k fornatted disks. Of 
course it is only useful on ASCII files (DOS- 
TEXT), 

ISEDIT - TStfORD. These Level 1 utilities will 
not run 'as is* under 0S9 Level 2. There is a 
patch for TSEDIT in the P.D. 'tsedit.arV This 
•Ipatch' file will patch TSEDIT so that it will 
run in a window. Ipatch will also be required, 
tfe do not know of such a patch file for TStfORD. 
Perhaps soneboby could help here. 

Sonebody wants a FORTRAH conpiler for the CoCo3, 
I guess there nust be a good reason for this 
request but we do not know of such a progranne. 
Can anybody help? 

SEVSLETIER COHTRIBUTIOHS. It is pleasing to note 
that a nunber of nenbers have indicated that 
they CAN contribute articles or questions for 
inclusion in our newsletter, tfe look forward to 
receiving anything in this line. 

Cheers, Gordon. 
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Basic09 Tutorial 
by Bob Devries 



I decided that I vould digress froia ny 
tirade about the CGFX2 library calls to explain 
the ansver to a problen that was posed by one of 
the Brisbane meiibers of the Usergroup. I can 
see he has a red face. He asked u if I knew of 
a progranne to read text file originating froE 
HS-Dos WordStar or iford-Perfect -and the like- 
word processors. These word processors set the 
eighth bit in some characters in the file. I 
said to bin, *why don't you write one in 
Basic09?'. He gave lae a queer look. 

The problen is really not very difficult, 
tfhat is needed to change the character froa 
high-bit-set to nornal? Eere's a bit 
representation of a character 'B' ... 01000010. 
If the high bit (bit 7, starting at 0) then the 
bit pattern is like this... 11000010. So the 
hexadecimal goes froa $42 to $C2, and the 
decimal from 66 to 194, 

To get rid of that extra bit, we use the 
Basic09 LAHD operator. Land does a Logical AHD 
operation between the two nunbers passed in its 
paraneter variables. The first parameter is the 
character you want to alter, and the second is 
the Bask to be ANDed with. First, let's look at 
how binary and works. Vhen two binary bits are 
ASDed together, the result only if BOTH the bits 
are set to L So in our exacple numbers here's 
what happens: 



files required is to read and write standard in 
and standard out, and use input and output 
redirection. In Basic09, that is easy. Here is 
the code: 



PROCEDURE filterhibit 


DODO 


DIM a:STEIHG(l] 


OOOC 


DIM b:BYTE 


0013 


WHILE liOT(EOF(tO) 


OOID 


GET »0,a 


0026 


b=ASC(a) 


002F 


b:LAND(b,$7F) 


003B 


a-CHE$|b) 


0044 


PUT 11, a 


0C4D 


ERDVHILE 


0051 


ESD 



DO 



$C2 
$7F 



11000010 
OllUlU 



See, only ten lines of code! First, 
diir.ension an input/output variable, 'a' as a 
single character string, and a byte variable 
'b'. ReneEber, we only need 8 bits, so a BYTE 
value is required. Ve then use a while/endwhile 
loop to read path (standard in) until an EOF 
(End Of File) is detected. Read the character 
into 'a', convert to ascii value in 'b', Logical 
AND 'b' with S7F, and change it back to a 
character value with CHR$. Lastly, PUT it out 
oil path 1 (standard out), and let 0S9 worry 
about where it goes. When EOF is detected, we 
quit. That's all there is to it. 

So you can see that Basic09 is really easy 
to use for even snail tasks like this. The 
comnand line for using this prograEnie is this: 



result: 01000010 which is 42, the value 
we really want. 

Hotice how we made sure the bit we want to 
discard is left as a in the mask, hence the 
$7F. 



filterhibit (isdos.txt >os9.txt 

Note that you can only use it once it has 
been PACKed by Sa3Lc99, and stored in your CHDS 
directory. Veil, thats all for now., keep 
trying those little prograsies in Basic09. 

Regards, Bob Devries 



OK, so now the easiest way to filter the 

ooooooooooOOOOOOOOOOoooooooooo 

CoCo-Link 
CoCo-Link is an excellent nagazine to help you with the ESDOS side of the Colour Coaputer. It is a bi- 
monthly magazine published by Kr. Robbie Dalzell. Send your subscriptions to: 

CoCo-Link 

31 Hedlands Crescent 

Pt. Hoarhnga Sth. 

South Australia 

Phone: (08) 3861647 
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The 059 File Systen 
by Bob Devries 



How does 0S9 find the files oa its disk 
devices? Hov does it know vhat the filers 
length is? How does it find what free space 
there is on a disk? How does it know which 
filenases are files, and which are directory 
naaes? 

I suppose we have all asked these questions 
at one time or another. I believe that there 
are very few people who actually know how their 
operating systes stores files, and how it 
retrieves them. Veil, I'd here to tell you 
about the way 0S9 and OS9/68000 does it. 

First of all, you should all know that 0S5 
can handle any size disk drive up to a maxinufi 
of 65535 bytes in its sector allocation table. 
There are eight bits in a byte, so eight 
clusters per byte of allocation table are 
allowed. A cluster is one ore more sectors 
grouped together and taken as one unit. Colour 
Cociputer 0S9 usually uses one sector clusters, 
so a disk is liiited to 65535 tines 8 sectors. 
Vith the format of the Colour Computer 0S9 disk 
being eighteen sectors per track, that would 
make 29126 tracks, and on double-sided disks 
14563 tracks. At the nooent, I don't know of 
any disk drives of that number of tracks. Even 
hard disk drives, which usually have 32 or 46 
sectors per track, that would cake 16383 tracks 
or 11397 tracks. My 20 Keg hard drive has 615 
tracks, and four sides (two disks) and 32 
sectors per track which nakes 73720 sectors 

0[, so how does 0S9 know what type of disk 
you are using? The answer is: by looking in the 
device descriptor in nemory, which has the data 
in it (among other things) to tell it how many 
tracks, sides, and sectors per track your drives 
have. That way it is easy to change hardware, 
such as from 40 track to 80 track drives. Just 
plug thei in, change the device descriptor, and 
go! 0S9, is however, even smarter than that. 
It will allow you to insert a single sided 35 
[or even less) track disk in an 80 track drive, 
and it will adjust itself accordingly. 

So where does it get the information? From 
the first sector of the disk on side 0. 0S9 
calls that sector LSSO (for Logical Sector 
Suaber 0). The first three bytes of that sector 
give the number of sectors on the disk, and at 
byte 16, 17 and 18 are the disk format (density, 
number of sides) and number of sectors per 



track. So 0S9 looks at that information and 
works out if it can read it with the current 
device descriptor. If the format is less than 
or equal to that descriptor, it reads it, 
otherwise, (if you put an 80 track disk in a 
drive with only 40 tracks) it returns an error 
'Vrong Type'. 

So once 0S9 has that information, it reads 
another three bytes of information from LS80 
(bytes 8,9 and 10) which tell it the sector 
number of the ROOT DIRECTORY. Actually, those 
bytes point to the file descriptor for that 
directory, not the directory itself. Vhen it 
has that infornaticn, it reads from that sector 
the sectors used by the root directory. In 0S9, 
each directory may be any length, and grows 
dynamically as needed (including the root 
directory, unlike sciae other systems including 
KS-DOS). So the file descriptor has in it the 
pointers to the sectors where the directory 
information resides on the disk, 

So now we come to the actual directory 
entries themselves. Each directory in 0S9 
consists of a 29 character filename (last 
character has 128 added to its ASCII value) and 
a^ 3 byte pointer to the sector which contains 
the file descriptor for that entry. The first 
entry is a pointer to its own file descriptor, 
and the second entry is a pointer to the parent 
directory. In the case of the root* directory, 
these point to the same sector, since the root 
directory does not have a parent directory. 
After these two entries come the filename 
entries or other directory names. The directory 
entry does not show if the name is a file or a 
directory name. This information is in the file 
descriptor, the first byte. If bit seven of 
that byte is set (to one), that entry is a 
directory, else it is a file. Directories are 
treated just like files in every other way, 
however, and may be read to see what is in thea, 
provided they are opened with the correct 
permissions (we'll look at that later). 

Deleted files have the first byte of their 
filename set to zero, and have the sector list 
and length in the file descriptor set to zero. 
The directory's file descriptor is updated every 
time it is lengthened by adding a new file to 
it, but it is not shortened. 0S9 itself (the 
EBF or Random Block File manager) takes care of 
looking for unused directory entries to fill. 
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Vhen 0S9 has found the filenane you vanted 
it to open, it looks first at the three byte 
sector nuEber vhich points to the file 
descriptor, then in the file descriptor there 
are up to 4fl segment pointers- vhich allov for 
file fragsentation. The 48 segnent pointers are 
made up of a three byte pointer to the first 
sector vhich contains the data of the file, and 
then a tvo byte value vhich is the nunber of 
sectors contained in that segnent. Let's look 
at an exanple: 

0440 4F5339426F6FF4F4 OS9Boott 

0448 0000000000000000 % 

0450 0000000000000000 

0458 OOOOOOOOOOOOOOOB ......,, 

This is a part of ay boot disk. Notice the 
second 't' in OS9Boot. It is just a character 
left over fron a previous nase in that directory 
entry, which has been deleted, and subsequently 
overwritten. Of course '0S9Bcot' is only seven 
characters long, and sost of the directory entry 
is filled with zeroes. The last three bytes, 
the sector pointer to the file descriptor of the 
file 0S9Boot, nake up the value SOOOOOB which is 
sector eleven. Let's look at the file 
descriptor: 

OBOO 0300005B080I15I8 ,..[..,. 

0B08 OI0000787A5B0801 ...X2[.. 

OBIO OOOOOC0079000000 ,...y... 

0B18 0000000000000000 

0B20 0000000000000000 

0028 0000000000000000 

0B30 0000000000000000 ........ 

0B38 0000000000000000 

0B4J 0000000000000000- 

0B48 0000000000000000 

0B50 0000000000000000 

0B58 0000000000000000 

0B50 0000000000000000 

0B68 0000000000000000 

0B70 0000000000000000 

0B78 0000000000000000 

0B80 0000000000000000 ....,.,. 

0B83 0000000000000000 

0390 0000000000000000 

0398 0000000000000000 

OBAO 0000000000000000 

0BA8 0000000000000000 

OBBO 0000000000000000 

0BB8 0000000000000000 

OBCO 0000000000000000 

OBCB 0000000000000000 

OBM 0000000000000000 



OBEO 0000000000000000 

0EE8 0000000000000000 

OBFO 0000000000000000 

0BF8 OOOOOOOOOOOOOOOO 

The first byte is the file's permission 
bits. In this case, only owner read and owner 
write are set. The next two bytes are the 
owner's user ID (usually 0). The next five 
bytes are the file's last modification date, one 
byte each for year, month, day, hour and minute. 
The next byte is the link count (I must look 
that one up elsewhere... it is not explained in 
the manual). It seems to be always one. The 
next four bytes are the file size, in bytes. 
Hext comes the creation date in year, month and 
day format, one byte each. 

The next 240 bytes are made up of a maximum 
of 48 five byte segments which each contain a 
three byte pointer to a block of sectors of the 
file, and a two byte value for the number of 
sectors in that block. If a file gets 
fragmented badly enough, you may get error 217 - 
Segment list full. This means that all 48 of 
the block pointers have been used. The best way 
to repair this error, is to copy the file to 
another disk. This will allocate the file 
differently, and will remove the problem. 
Personally I have never struck this problem. 

^ So, to access the file whose file descriptor 
is displayed above, 0S9 reads the length from 
bytes nine and ten, which gives a value of 5787A 
or 30842 and then gets the file position 
pointer from bytes L6, 17 and 18, which gives 
500000C which is sector 12. The next two bytes 
are the number of sectors (actually clusters) 
which contain the file, vhich gives $0079, 121 
decimal. Because the next three bytes are 
zeroes, 0S9 knows that no more clusters are 
being used. The three byts pointer is converted 
to a four byte (long) value and is passed to the 
system call which reads the sector data. The 
number of bytes to be read from the last sector 
is worked out by multiplying the two byte 
segment value (121) by 256 (the number of bytes 
in a sector) and subtracting the file size 
(30842). This leaves 134 bytes to be read fron 
the last sector. And voila! the End Of File is 
reached. 

Veil, I hope you all made something from 
that. I know I learnt something from looking it 
all up. Until next time... 

Eegards, Bob Devries, 
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Utine.h header file for kreider library 

It has been brought to our attention that there is a problen in the Public Doiain library archive 
file 'header, ar' on disk t. The archive contains several header (.h) files vhich are needed for the C 
library from Carl Kreider. The header file in question, the last one in the archive, is utime.h. It 
appears that the last few lines are missing. Here is the coiplete file in its correct forn: 



/* 








** Ut 


ine.h 






*/ 








struct tsi 


( 






int 


tE sec; 


/* seconds (0 - 59) 


V 


int 


tn Bin; 


'/* Einutes (0 - 59) 


*/ 


int 


tE hour; 


/* hours (0 - 23) 


*/ 


int 


ti Bday; 


/* day of Eonth (1 - 31) 


*/ 


int 


ts Don; 


/* Eonth of year (0 - 11) 


*/ 


int 


ta year; 


/* year (year - 1300) 


*/ 


int 


tE ¥day; 


/* day of seek (Sunday - 0] 


*/ 


int 


tE yday; 


/* day of year (0 - 365) 


*/ 



int tE isdst; /* HOT USED 



long 


tiEeO; 


/* Sase as UNIX •/ 


struct tE 


'localtineO; 


/♦ Sace as UHIX */ 


char 


'asctineO; 


/* Same as UNIX */ 


char 


*ctiae(); 


/* SaEe as UHIX */ 



long o2utiEe(); /* Convert 0S9 style buf to UNIX long */ 
/* Void */ u2otiiie(); /* Convert 'tc' to 0S9 char *buf */ 

Rest assured that ye vill be changing the library file on the PD disk to renove any further cause 
for concern. This problei caused sone consternation with local group neibers who tried to compile a C 
programme which called the function o2utime() which, because it was not declared, returned an integer 
value instead of a long as it should. Hope this clears up some problems. 

ooooooooooOOOOOOOOOOoooooooooo 

68kxx Machines 
A new magazine for Motorola processors 

At the beginning of this year, a new 1 Year (surface mail) US$17. 25 
magazine was started in USA by Mr Jim DeStafeno, 2 Years ' ' US$33.50 
called BSxxx Machines. It is a magazine devoted 1 Year (airmail) US$22.50 
only to Motorola processors, and in particular 

to the 68000, 68010. ..020 etc. Thus it covers All major credit cards are accepted, but 
OS9/68K, and various operating systems including attract a lOl surcharge. The address is: 
SK*DOS. Articles presented cover Basic09, C, 
assembler, as well as general interest subjects. The 68xxx Machines 

ED I, Box 375 
Subscription rates to Australia are: lifyoaing DE 19934 

USA 

ooooooooooOOOOOOOOOOoooooooooo 
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SMILE! 


YOU'RE ON CANDID CAMERA! 


Date: 


12-24-88 09:41 




:>) subiiitter has a big nose 


From: 


Werner Cappel 




:(| subiitter attends an Ivy League school 


To: 


Eon Dwight 




'A)\ subfiitter has acne 


Subj: 


Re: Jokes, Smiles and Clarity 




=:-) submitter is a hosehead 

:-(* submitter is getting sick of most recent 




Here's the file : 




netnevs articles and is about to vonit 


:-) 


Joking or sarcastic face 




:-)8 submitter is veil dressed 


:-) 


Fiendish grin 




8:-) submitter is a little girl 


;-) 


A vink 




:-)-|8 submitter is a big girl 


:-( 


Sad or angry face 




\'] submitter is cross-eyed 


t"( 


Late night 




*-) submitter partyed all night 


T 


Stirring up trouble 




:-* submitter just ate a sour pickle 

-:-) submitter sports a mohavk and admires 


:-) 


the nornal smiling face, appended 


to a 


Mr. 17 


sentence or an article seans 'this is a. joke' or 


(:)-) submitter likes to scuba dive 


'this 


IS supposed to cake you laugh' 




:-'! submitter has a cold 



:-> normal smiling face with deformed lips, 

same as above except person who submitted it 

has problems vith their lips 

:-[) normal smiling face with a mustache, same 

as fl except submitter has mustache 

:-[ normal smiling face with pretty lips, 

same as il except person that submitted it is 

wearing lipstick or some other lip appearance 

improving device 

:-| no expression face, 'that comment doesn't 

phase me' 

:-( sad face, 'that comment makes me sad 

[nadl' 

;-) smiling face gets his lights punched out 

(could be pirate sailing face??), submitter is 

a practical joker who played one too many and 

got beat up 

;-l no expression face gets his lights 

punched out, says nothing but still gets beat up 

;-( sad face gets his lights punched out, sad 

or mad and got beat up, or 'that makes me so mad 

that if I ever see you I'll punch your lights 

out' 

:-\ popeye smiling face, for people who look 

like popeye 

;-\ popeye gets his lights punched out 

:-] biting sarcasm smiling face, used vhen 

sarcasm is intended, since we cannot inflect our 

voice over the net 

:-[ biting criticism smiling face, ditto for 

criticism 

:*) drunk smiling face, for those of us who 

like get intoxicated before or vhile reading 

netnews 

: ) smiling face needs a nose job, no 

explanation necessary 

: submitter is a robot (or other 

appropriate AI project) 



:-)' submitter tends to drool 

':-) submitter accidentally shaved off one of 

his eyebrows this morning 

(-: submitter is Don Ellis from Tektronix 

8:] normal smiling face except that submitter 

is a gorilla 

\-' submitter is Picasso 

(-: submitter is left-handed 

0-) submitter is an arc-welder 

submitter is a Bozo 

submitter wears glasses 

submitter is Santa Glaus (Ho Go Ho) 

submitter is a cyclops 

submitter with long bangs 
(-) submitter needing a haircut 
0-) submitter wearing scuba mask 
*-( Cyclops got poked in the eye • 
\-] person submitting has been staring at the 
terminal for 36 hours 



:o, 



o'-l 



B-; person 
sunglasses 

P-; 



submitting is wearing cheap 



joint. 



closed 



person submitting is getting fresh 
submitter has had his nose put out of 

Useful for replying to flames. 

Submitter is asleep (boredom) 

Submitter has one eye 
Submitter only has a left eye, which is 



') Submitter has two noses 

-D Submitter talks too much 

-0 Submitter is shocked 

-( submitter has read too many of the toilet 

paper articles previous to lunch 

:-\ Respondent has beard. 
:-J Respondent's beard has permanent wave 
*or* was drawn by Picasso. 

:-f Respondent's lips are sealed. 

-(:-) Submitter is the pope 

::-) respondent wears glasses 
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11: 
(1- 

c- 

thi 
:-( 
art 



:-) 

01- 
l-D 
:-) 

8:- 
:-( 
X-( 

:-[ 

E-: 
:-0 
>:- 

3:c 



:-? 

:-X 

:-0 
(:I 

(:r 

S-1 
B-! 



respondent vears lipstick 

Submitter is wearing toupee, 

Subfiitter, wearing toupee in wind. 

Submitter is Chinese, (sorry bout that) 
[' Subcitter is Chinese and doesn't like 
s article, 

Subaitter has read too Eany 'sniley' 
ides. 

ha ha 

net. f lane 

hee hee 
1 net. religion 

ho ho 

hey hey 
I net.unix-vizards 

boo hoo 

net. suicide 

-I net.has-radio 

uh oh 
I net.startrek 

nyah nyah 
[ net. pets 

yuk 

beard 

austache 

braces 

boy tie 

SEioker 

dunce 

egghead 

glasses 

horn-risis 

glasses on forehead 

condescending stare 

wink 

Dad 

smiley spittiiag out its chewing tobacco 

SEiley bland face 



-? 



:-6 

'/] 

:-7 

3-1 
.* 

-& 

-9 



ssiley face screasiing 

siuiiey face with bushy nustacbe 

smiley face with it's mouth wired shut 

smiley banker 

smiley after eating something sour 

smiley with pointy nose (righty) 

smiley after a wry statement 

smiley swimmer 

smiley after eating something bitter 

smiley which is tongue-tied 

smiley licking it's lips 

smiley orator 

un-smiley 

smiley standard 



smiley invisible man 

unsmiley frowning 

smiley big-face 
I 

unsmiley big-face 

scuba smiley big-face 

smiley punk-rocker 

(real punk rockers don't smile) 
=:-f) smiley punk with a mustache..., 
:-) smiley priest 

:-q smiley trying to touch its tongue to its 
nose 

:-e disappointed smiley 
:-t cross smiley 
:-i semi-smiley 

:-o smiley singing national antheE 
:-p smiley sticking its tongue out (at you!) 
;-[ uD'smiley blockhead 
:-] smiley blockhead 
:-( smiley variation on a theme 
:-) ditto 

(:-) smiley with its hair parted in the middle 
1:-) above in an updraft 

lefty sailely touching tongue to aose 

smiley after a BIZARRE comment 

lefty smiley razzing you 

smiley with pince-nez glasses 

left smiling smilely 

beats me, looks like something, tho. 

y. a. s. 

mutant smiley 

undecided smiley 

"have an ordinary day' smiley 

winking smiley 

real sad smiley 

y . a . s . 

y.a.cs. 

'my lips are sealed' smiley 

bummed out smiley 

talking head smiley 

left-pointing nose smiley 

left-pointing tongue smiley 

lefty undecided smiley 

smilely smoking a pipe 

one-eyed smilely 

wry and winking 

smiley cyclops (scuba diver?) 

older smiley with mustache 

smiley with funny-looking left nose 

smiley with funny-looking right nose 

midget unsmiley 

midget smiley 
12 remark was only half in jest 'fe'e laugh 
because it hurts so much' 



:-a 

:-s 

:-d 

g-) 

1 

k 

1 



ooooooooooOOOOOOOOOOoooooooooo 
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Some Notes from the InterHet 0S9 area 



C Compilers, and 68K machines 
- James Jones 

Recompiling C code from CoCo 3 source to 
machines such as the KH/1 fill require some 
alterations. One case in point is »hat to use 
in place of the os9.h file, for use on the 68K 
platforms. You may recall, that os9.h contains 
a declaration of a structure that corresponds to 
the registers of the 6809. 

Such a structure wouldn't' do much good on a 
i^h^l Even if one wrote something that 
corresponded to the 6S0xx's eight data and eight 
address registers, the code containing the 
Ifinclude vould certainly have to change. 



Further experimentation shoved that the specific 
part of the code that ¥as position-sensitive vas 
the read and vrite sector loops. These loops 
are very tight, tricky code in which bytes are 
transferred to and from the disk as fast as the 
CPU will alloy, with no time to even do a 'end 
of loop' test to get out of the loop — that is 
handled by an SHI from the disk controller that 
kicks the CPU out of the loop and into a 'end of 
sector' routine. 

Successive tests showed that the loop would be 
flaky on one out of every four addresses... if 
it was bad, I could fix it by moving it down 
one, two, or three bytes. But if I moved it 
down or up by four, the problem vould remain. 



Although there is a syscall for Microvare BASIC 
(the 680XX equivalent of BASIC09), it, too, has 
to have a different TYPE statement, and 
references to that have to change 
correspondingly. (One of the fev sources of 
incompatibility between 5ASIC09 and Hicroware 
BASIC.) 

The C library for OS-9/68000, on the other hand, 
has gone the route of having individual 
functions corresponding to system calls instead 
of the catcall _os9(). People who have been 
using the Carl Kre'ider library under OS-9/6809 
win big here, because his library takes the 
approach used in OS-9/68000, and changes to code 
using his library should be minimal for a port 
to OS-9/68000. 

More BLOB'S 
- Rick Adams 

Ky explorations into the BLOB problem came about 
when I noticed a 3109 of my own in a piece of 
RSDOS code. Scrmally, this is very rare, but I 
found that modification of DELPHIterm's code 
would sometimes cause its disk drivers to become 
flaky, dropping a byte on a sector read or write 
about one time out of every 20 reads. 

Experimentation shoved me that I could fix the 
problem, if it occurred, by inserting or 
deleting two NOPs just ahead of the disk driver 
code. It wasn't a subtle timing change due to 
the time it took the ROPs to be executed, 
h^r^^voQ t-Hev i^e^en't executed -- they were just 
'spacers' used to move the disk driver code down 
two bytes. This ALWAYS fixed the problem. 



I speculated then that the 0S9 BLOB could be 
reliably conquered via the use of a small 
'spacer' module that did nothing but move the 
0S9 disk driver module down just a smidgeon... 
as long as the length of the module was NOT 
divisible by four, :-) 

For some reason, I've never had a BLOB in my 
boot (tho I *do* use 0S9 extensively, and fiddle 
vith my boot now and then), so I've never been 
really motivated to try this. 

Ifore News on CoCo BLOB's 
- Kevin Darling 

I suppose it's okay to mention something now. 
Years ago, Tandy knew about the BLOB, at least 
as related to bad disk reads under ESDOS. That 
was something I'd never heard of, but apparently 
they had. So they had Western Digital spend 
weeks trying to track down the problem, but it 
was never found. 

I think (not sure) that VD subcontracted the 
microcode, and that didn't help either. Western 
Digital didn't have the source or something. In 
any case, people have been chasing this sucker 
for quite some time now, if that helps any 
(grin). It may be that many computers had 
similar problems, but we were just more likely 
to notice them (since we expect our machines to 
be perfect :-). 

It has also been mentioned that 'E-clock gating' 
wf?5 a possible fix, which was recommended 
earlier by C. Bundy on the CoCo Internet List. 
However, on systems using a Disto SC-II, this 
fix is included in the disk controller board. 
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Perhaps other systems could try it. 

This can be done by juEpering the expansion bus 
pin 6 to pin 4D inside the CoCo. That ties the 
E clock to the SLENB line on the 138 chip. Do 
not try this fix unless you understand exactly 
what you are doing. 

EEC 3D Monitor (-) CoCo 3 
- TiE Kientzle 

Perhaps it vas a silly thing, but soiewhere in 
the process of thinking about buying a new 
conputer, I ended up with a monitor before I got 
the conputer. Thinking that a 'good" Multisync 
would be generally useful for any computer I 
would be likely to get, I junped at a g.ood price 
on the SEC 3D. 



not a signal dependency. 4fhen set to analog I 
got little blue dots, but no picture... 

The Kec 3D unlike the less expensive Eelysis 
will do configuration with no switch settings. 
The node/color switches are used to fine tune 
(or override) what the Nee 3D has deterained 
about your video display. In the case of the 
CoCo III try Mode switch OFF, Color Switch AUTO. 
Regardless, you should get iiore than a blank 
display no matter what those switches are set 
to. 

Hake sure all ground pins are tied together on 
the 15 pin HD connector. These pins should go 
to pins 1 and 2 on the CoCo connector, The pins 
are 4, 5, 6, 7, 8, 10, 11 (6=R Gnd; 7=G Gnd; 8=B 
Gnd; 4, 5, 10, 11 Gnd). 



How, I'm trying to connect this beast to my 

CoCo3, and the lack of success is making me 

doubt ny decision. Does anyone know how to do 
this? 

P.S. Predictably, SEC custoner support has been 
less than helpful so far. But, it _is_ a free 
call, and I's perfectly willing to keep 
bothering them until I get a useful answer, 
(grin) (Something other than 'Is that CGA, EGA, 
or VGA??" <sigh>) 

Answer 1 

- Charles C, Bundy 

Grab a female 9 pin sub-D connector. Make a 
cne-to-one connection from the CoCo's EGB 
connector to the 9 pin. (Note pin ID from the 
CoCo isn't used.) You can find the pin numbers 
marked on the front/back of most 9 pin sub-D's. 
I'm not sure of the CoCo orientation, but the 
numbers are marked on the motherboard. Make 
s^jre 1 goes to 1, 2 goes to 2, etc. Don't worry 
about the sound pin (7, I think) it goes to an 
equivalent K on the 9 pin side (CGA/EGA pinout 
standard 7(iC). Once you have your 9 pin 
connector you'll need to plug the HD 15 pin 
adapter in to the NEC 3D side. (I hope you got 
one of these with the monitor! Plug that into 
your 9 pin and you're set. I've used a Eelysis 
and SEC 3D HultiSync monitor on my tower case 
CoCo - works beautifully, (The NEC 3D won't 
need any switch settings but the Eelysis 
required the auto/manual 

switch be set to manual and the TTL/analog 
switch set to TTL). Yes, TTL! All 16 colors 
showed up while playing Sinistarr, so I'm 
cssuming it was a frequency dependent setting, 



I would still recommend going with a CGA 
connector on the CoCo and using the 15 to 9 pin 
adapter. This has worked for me. 

Answer 2 
- Ken Scales 

The limited info I have for the NEC 3D gives the 
following pinouts for Analog connections with 
separate Hsync and Ysync: 



Monitor 


Signal 


Coco 


Pin Number 




Pin Number 




Red 






Green 


4 




Blue 






H Sync 






V Sync 






Eed Ground 


(1) 




Green Ground 


(1) 




Blue Ground 


(1) 




Ground 





(Of course, the third column is my own addition 
-- NEC left this info out of their manuals 
(grin)). 

Note these pinouts are COMPLETELY different from 
those for a CGA-type of connection, which would 
have the monitor pins connected to the same- 
numbered pins on the Coco — that arrangement 
will give you only 8 colors. 

Looks like the NEC uses similar methods to the 
PanaSync for switching between the different 
modes: checking for Sync signals on certain pins 
which would indicate whether it should operate 
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in TTL/CGA/EGA (sync on pics 8 and 5), PGC 
Analog (conposite sync on pin U, or 
VGA/HCGA/KACII Analog (H sync on 4, V sync on 
5), (Actually that last part was a bit of a 
simplification, but covers the highlights.) 

Delays Everywhere! 
- Kevin Darling 

[Thought y'all would find this atusing, since it 
refiinds ne of sone Internet postings I've read 
lately about the new OSK Eachines,..] 

•This is the way that it is SUPPOSED to work, 
but unfortunately it isn't. As soEebody said at 



a user group ceeting Saturday 'The only 
[Conpany X] has shipped lately is excuses' 



thing 



There have been numerous cosplaints here fron 
individuals who have been waiting ^6 weeks for 
aachines and nany of those thai have got their 
[aachinesl can't get a newer [version of 
windows!. Other users mentioned at our leeting 
that [Company X'sj 1-300 nutber is not being 
answered either these days. 

Sorry to vent so Biuch stean. Even though I have 
my [nachinel and can live with [current 
software] for the tine being, I feel real sorry 
for friends that have heard excuse after excuse 
this summer. 

First in late Kay it was that there is a backlog 
and it will take 2 weeks to get a machine in. 
Early June it was '[Conpany XI shut down for a 
week around Hesicrial day. Shipping will start 
KondayV About 2 weeks ago it was The Eachines 
will be shipped on Friday, and will take about 3 
or 4 days to get here." 

Last week it was 4-8 weeks, at the earliest. 

What more can I say!" 

So who is the "Company X' "hat's being ripped 
here? In this case, CoEmodore. And the machine 
is the Amiga 3000. But you can find the sane 
thing in Atari, NeXT, and even Apple forums. 

That's just the way it sometimes goes, 

HH/1 Sews 

- Kark Griffith 

From a recent IMS announcement, it looks like 
the HK/1 will be able to send and receive faz 
images! 



That fax deal is just a sendfax modem and some 

software to send text files - 

to the modem to send out as a fax. It can't 

receive fax images. I'm sure 

someone will do that in the near future. 



Vhat are people are conteaplating for a backup 



medium for their KK/l's. 



is going to take 
Kbyte ones. 



a lot 



A 105Kbyte Hard Disk 
of floppies, even 1.44 



Carl Kreider has been working on some tape 
drivers for a couple different tape units. As 
soon as he is finished with his current projects 
(the KK/L SCSI driver and new floppy driver), he 
will probably get back to the tape units. Ee 
does have the drivers working on Atari ST 
machines, so it should be pretty easy to port to 
the HM/l. The only problem is going to be 
finding a fairly cheap SCSI tape drive that is 
also reliable. The TEAC units are darn good, 
use those audio cassette looking tapes, store up 
to around 60 or 70 meg, but aren't cheap. 

Soce good news is future KH/I designs will 
support the newer 4 Keg floppy disks. Only a 
couple minor changes need to be made in the PCB 
to handle it. 



Vhat is in the mysterious Level 2 upgrade? 
-'Mark Griffith * 

A new ACIA driver. Very Similar to Bruce Isted's 
SACIA driver. (tfhich is available from him 
directly along with his Eliminator board, and 
has the same features as the upgraded Level II 
version). I'm making an educated guess that the 
two drivers are one-in-the-same, or at least 
functionally the same. 

This driver required a new clock module to work 
at its best, which was included in the Level II 
upgrade. driver. 

As well as a better serial driver, it included 
new kernel modules that changed the way OS-9 
tasks switches making it all much smoother and 
causing most processes to run slightly 
faster.,. or at least appear to do so. There 
were also small changes to fix known bugs that 
had been there for years. 

SBF was changed to allow undeleting a file or a 
whole directory. There is even an UNDELETE 
utility included. 
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The GFX2 file nost BASIC05 programers are 
faniliar rith was a result of the upgrade. At 
one tine, vector fonts vere supported and I 
believe Hershey Fonts were being worked on at 
one point. A neat little deao was nade that put 
up on the screen (real fast I night add) fancy 
cursive characters that said: 

'This is HOT your Father's 05-9' , 

These fonts were dropped though! 

Support is in there for noveable, overlapping 
windows too. Pretty fast and easy to use, Move 
the mouse over a window and press the select key 
(yes, the second button on the mouse was used 
for window select) and that became the active 
window. You could even update the window in the 
background as you used the one in the foreground 
(not nearly as slow as you night think). 

rm sure there are other things in there I can't 
reseaber now. It was certainly worth the effort 
for the people involved to do it. Too bad Tandy 
killed it before it could be released. 

Backing up hard disks 

Peter Edwards asks: 

Now that I have sy hard disk running on ny CoCo, 
I have to figure out how to back it up. 



I have tried BRU, from Delphi, and it worked 
well, but took about 15 ainutes per 360k floppy. 
Pretty slow, especially if you compare it to the 
tine Fastback+ can duip IBM disks. (IHHO, if 
you really KUST use a PClone, you GOTTA have 
Fastback+.j bonder if BRU would benefit from a 
different interleave on its floppies? Hmm,,. 

I also have the Burke i Burke HDB/BDE programs, 
and the HDRIT suite froii the CoCo Internet List, 
although I haven't tried them yet (have to go 
buy fiore floppies first!) 

Vhat do people use, and are there any coEEents 
on the three mentioned above? Are there any 
others around? 

Elena Marcias Replies: 

I use HDB from Burke S Burke for my 30 Heg 
drive. It takes about 20 720K disks to do a 
complete backup so I speed things up by turning 
off the write verify on the floppy drive to 
which I write. I do this by running: 
dmode /f2 vfy=OI (f2 is the drive I backup to). 

This way each disk takes only 3 minutes! To be 
on the safe side, once a year I backup up all 
my files with AR so I can restore them in case 
aiy of the HDB disks are damaged or contain 
errors. 



ooooooocooOOOOOOOOOOOoooooooooo 
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